.. highlightlang:: us

.. index:: @f{ncvaluefromdata}

.. _@f{ncvaluefromdata}:

@f{ncvaluefromdata}
===================

.. us.tag  @f{ncvaluefromdata} NOTREADYENGLISH fieldfunction

Displays the value of a data point of a netCDF data file channel. The file name 
of the netCDF data file will be received via the connected dataset.

.. function::    @f{ncvaluefromdata(DatasetName, ChannelName, PointNo)}
   @f{ncvaluefromdata(DatasetName, ChannelName, PointNo, ssFormat)}
   @f{ncvaluefromdata(DatasetName, CahnnelName, PointNo, ssFormatFuncName)}

.. us.params

**Parameters**

.. uparam:: DatasetName

   Is the dataset name, for example ``Data1``. The dataset name of the selected
   dataset will be displayed in the status bar. The dataset name is used to 
   receive the netCDF file name.

.. uparam:: ChannelName

   Is the channel name of a netCDF file.

.. uparam:: PointNo

   Is the point number starting with 1. Negative point numbers access a point 
   starting from the end. The value -1 returns the last data point.

.. uparam:: ssFormat

   Is an optional format string (see :ref:`printf`).

.. uparam:: ssFormatFuncName

   Is the name of an optional format function::

      def MyFormat(ssText)
      {
         ssNewText = ...
         return ssNewText;
      }

.. us.example

**Example**

``@f{ncvaluefromdata(Data1, N, 0)}``

**Output**:

``600.00``

**Example**

::

   def MyDateFormat(ssText)
   {
      // Example: G100616_3
      ssYear = strextract(ssText, 2, 2);
      ssMonth = strextract(ssText, 4, 2);
      ssDay = strextract(ssText, 6, 2);
      return ssDay + "." + ssMonth + ".20" + ssYear;
   }

.. code-block:: none

   @f{ncvaluefromdata(Data1, DataFile, -1, MyDateFormat)}

**Output**

``16.06.2010``

.. seealso::
   :ref:`overview-field-functions`,
   :ref:`editupdate-fields`,
   :ref:`diagraminsert-field-function`,
   :ref:`@f{ncattfromdata}`

:sub:`id-1069126`